Shareware Super Platinum 8

home *** CD-ROM | disk | FTP | other *** search

/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / ARCHIVE / PKZMVOL.ZIP;1 / PKZMVOL.DOC < prev next >

Wrap

Text File | 1994-05-13 | 23.6 KB | 646 lines

PKZMVOL : Allow PKZIP to use multi-volumes diskettes for ZIP file PKZIP/PKUNZIP are called thru an interface program (PKZ.EXE) to be able to save and restore large files and directories on several diskettes (max. 100). This enable the save of an entire disk. That interface can also be used as a backup strategy based on directories and, for people who have not enough space on their disk to hold all their applications, it is an easy way to use applications keept in ZIP files. PKWARE version 1.1 or 2 is needed. Note : In that document symbol ê is used to represent a back-slash CHANGES ------- V2.4 04/05/94 - PKZ now works with the last version of PKZIP/PKUNZIP on PCTOOLS (PKZIBM PACKAGE). V2.3 03/11/93 - new option /A (PKZ and PKZCFG) to set alert (beep when message is displayed). - Possibility to answer E (erase) or F (format) when message : "Insert next diskette to write ZIP" is displayed. - PKZ now works with the Family version of PKZIP/PKUNZIP but only on DOS or OS/2-DOS session. V2.2 08/17/92 - correct a bug with /FD or /X : restore a list of files V2.1 05/19/92 - correct a bug with /FD and /FS - correct a bug for /X and /L with large ZIP file - add message when PKZIP/PKUNZIP is not found V2.0 05/12/92 - new program : PKZCFG.EXE to set PKZ default options for save and restore (PKZIP/PKUNZIP), then you can customize all default options including /Zx and /Bx. Standard defaults are changed to : -u -p -r -whs -Jhsr -o for PKZIP (save) and : -d -n -Jhsr for PKUNZIP (restore) Don't use -bx option of PKZIP but /Bx option of PKZ. With that defaults all files will be saved and restored including hidden, system files and sub-directories. The configuration file PKZIP.CFG is no longer needed (except for the view option). - new options : /OS(...) and /OR(...) to change defaults options for PKZIP (/OS) or PKUNZIP (/OR) only for ONE call to PKZ. Needed PKZIP/PKUNZIP options must be given between parentheses. - new options : /X and /L to display a paginable list of ZIP file content. /X can be used instead of /R to get a list of all files and select (space bar at cursor position) files to be restored (a list of files is build and passed to PKZIP, that minimize diskettes manipulations). /L can be used instead of /V to be able to roll and sort the list as needed. For that options PKZ calls another program : PKZL, to keep memory requirement as small as possible (24K). V1.1 02/24/92 - correct a bug when SHARE is used - new option /N to suppress the test of ZIP file after a save - Avoid erase of current directory if no /D before /E - Changes to support the package ZIPEX (allow to unzip files from a list) To use it you can call : PKZ ZIPEX Z:ZIPFILE or PKZ ZIPEX and then enter Z:ZIPFILE in the prompted window or PKZ /ZG ZIPEX to use drive G instead of A or PKZ /D C:êTEST ZIPEX to restore to C:êTEST ... INSTALLATION ------------ The files you should get from PCTOOLS are : - PKZMVOL DOCUMENT that file - PKZMVOL EXEBIN a self-extracting file which contains : PKZ.EXE the main program PKZCFG.EXE the customization program PKZL.EXE an extension of PKZ for some options PKZIP.CFè a PKZIP configuration file example PKZIP.XF a list of exclude file Download PKZMVOL EXEBIN as PKZMVOL.EXE in the directory where PKZIP and PKUNZIP programs are. Make that directory the current directory and call PKZMVOL. The five files PKZ.EXE, PKZCFG.EXE, PKZL.EXE, PKZIP.CFè and PKZIP.XF must be installed in the same directory as PKZIP.EXE and PKUNZIP.EXE PKZIP.CFè is a configuration file for PKZIP. If you have not your own configuration file, rename that file as PKZIP.CFG ; that file can be change (see the PKZIP documentation). That configuration file is only needed for the view option ; for save and restore options use the customization program PKZCFG to set PKZIP and PKUNZIP options as you want. PKZIP.XF contains a list of files to exclude during directory save operation. The present file excludes only *.ZIP files ; you can edit it to change the list. USING PKZ --------- At the DOS prompt enter : PKZ without any parameter to get a list of all options. PKZ -^- ¯option ¯value[[ -^--------^- ¯program ¯parameters[[ -^-- ? ! ! ! è--------------------% è---- ¯list of files[ -----% First is a list of options with their associated value, then, depending on the last option used, you can indicate a program to execute or you must give a list of files. Each option is prefixed with a dash (-) or a slash (/) and must be followed by its associated value, if any. Possible options and values are : /D : value is the directory for following options : R, X, S or E It is generaly the first option ; this is needed to indicate for the following options what directory will be used to restore in, to save or to erase. That option can appear more that once (up to 5) to be able to save, restore or erase several directories. If an option R, S or E appears before the first /D, then the current directory is concerne with that operation. The last /D indicate the directory to be made the current drive and directory for program execution, if any. /R : value is the ZIP file to restore into previous specified directory You give the ZIP file name as for PKZIP program ; drive and path can be specified. The default extension is .ZIP. To indicate to PKZ that multi-volumes diskettes processing is requested, you MUST indicate the drive letter Z instead of your normal diskette drive. Drive Z is assumed to be a multi-volume ZIP file in actual drive A: ; that can be changed by the /Z option to be able to use other drive unit. If drive Z is used, the ZIP file name cannot contain a global file name character (* or ?). PKUNZIP parameters used are : -d and -n. Up to 4 /R (or /X) can be specified for a PKZ command. /X : value is the ZIP file to restore into previous specified directory Used instead of /R to be able to select files to restore on a displayed list. Look at PKZL description to know how to select files. /S : value is the ZIP file to save the previous specified directory See /R option for ZIP file name considerations. The file PKZIP.XF is used as a list of exclude files. PKZIP parameters used are : -u and -b, all other options are taken in the PKZIP.CFG configuration file. After all save operations, a test is requested on the new ZIP file to insure that all is readable. Up to 4 /S can be specified for a PKZ command. /N : indicate that test must no be done after a save to ZIP file (no value is associated) That option must be used carefully, the new ZIP file is not tested after save so you have no quaranty that it is readable. /V : value is the ZIP file to display contents See /R option for ZIP file name considerations. The VIEW parameter in the PKZIP.CFG configuration file determine the information provided. Up to 4 /V (or /L) can be specified for a PKZ command. /L : value is the ZIP file to display contents Used instead of /V to be able to roll and sort the list of files. Look at PKZL description to see how to use the list. /E : indicate that previous specified directory is to be erased after program execution (no value is associated) All files in the directory are deleted, including all sub-directories and read only files, then the directory is removed. The operation is not done if a root directory is specified or if no directory have been indicated before (no /D before /E). Up to 4 /E can be specified for a PKZ command. The 5 previous options can be combined, ex: /RSE, /DE /A : reverse the default setting of the Alert option. When Alert is requested there is a beep when messages are displayed. PKZ default is No Alert. If you add /A option alert is set. Using PKZCFG /A set the default to Alert, then /A option on PKZ prevent alert. /Bd : d is the drive for temporary ZIP file used for update (default is C) (no value is associated). When /S is requested, PKZIP look if ZIP file already exists ; if ZIP file does not exist, PKZIP creates a new ZIP file ; if ZIP file exists, PKZIP read first that file and determine if update is needed (files have been changed or new files exist), to do that update PKZIP creates a temporary file on drive specified by /Bd. If you have a VDISK (or RAMDRIVE) large enough (E: for example), it is better to use it for temporary file specifying : /BE To change the default options look at PKZCFG program. That option can appear anywhere before program name or list of files. It is used for all current PKZIP operations. /Zd : d is the drive to be substituted to Z: (default is A) (no value is associated). Drive Z: is used for ZIP files to allow multi-volumes diskettes processing. If your 5"1/4 diskette is drive G: and you want to use it, specify : /ZG. To change the default options look at PKZCFG program. That option can appear anywhere before program name or list of files. It is used for all current PKZIP/PKUNZIP operations. /OR(...) : changes restore options for PKUNZIP Between parentheses put all PKUNZIP options that you want for that PKZ execution. All default options are replaced by new options specified. Example : /OR(-d -jhsr) to create directories and unmask H S R attributs. To change the default options look at PKZCFG program. That option can appear anywhere before program name or list of files. It is used for all current PKUNZIP operations. /OS(...) : changes save options for PKZIP Between parentheses put all PKZIP options that you want for that PKZ execution. All default options are replaced by new options specified. Example : /OS(-u -P -r) to update ZIP file, recurse directories and keep all pathnames. To change the default options look at PKZCFG program. That option can appear anywhere before program name or list of files. It is used for all current PKZIP operations. The 3 following options are exclusive, only ONE can be used for a PKZ request and it MUST be the last option. If one is used, no program can be indicated and all following parameters in PKZ command are a list of files to be passed to PKZIP or PKUNZIP. /FS : value is ZIP file for save (see /R option for ZIP file name considerations). First parameter after /FS is the ZIP file name. All following parameters are passed to PKZIP, it is the list of files to save to the ZIP file. /FD : value is ZIP file for delete (see /R option for ZIP file name considerations). First parameter after /FD is the ZIP file name. All following parameters are passed to PKZIP, it is the list of files to delete in the ZIP file. /FR : value is ZIP file to restore (see /R option for ZIP file name considerations) First parameter after /FR is the ZIP file name. All following parameters are passed to PKUNZIP, it is the list of files to restore from the ZIP file. Files are restored in the directory specified by the previous /D. If /FS, /FD and /FR are not specified, parameters after the last option and associated value are treated as program to execute and its parameters list. The program name should be an .EXE or .COM. To execute a .BAT or an internal DOS command you must specify : COMMAND /C xxx.bat parms USING PKZCFG ------------ PKZCFG can be used to change default options of PKZ. That options are : /A /Zd /Bd /OR(..) and /OS(..). They are used the same way as there equivalent options in PKZ but replace the default for future use. Any unspecified option is set to the standard value. Calling PKZCFG without parameters restore all standard options of PKZ and display a message describing the options and their standard values. Use carefully /OR and /OS, specially if PKZ is used to backup directories. For example, if -r is missing in /OS, PKZIP does not save sub-directories but, if /E is also used, all sub-directories will be erased and files can be lost. PKZL : List of files -------------------- That program is called by options /X and /L. It displays a list of files with : the file modification date, file size and file name (including path information if -p or -P is used to create the ZIP file). First the list is sorted by name, then function key can be used to change the list : - F8 : sort files by date (latest first), - F9 : sort files by size (biggest first), - F10: sort files by name. Roll Up and Roll Down change the current displayed page. The End key put the cursor on the last file and the Home key on the first file on the current list. All Cursor keys move the cursor up or down. F3 exit from the program and return to normal PKZ functions. Escape exit from the program but list of files selected is not build and nothing is restored for current /X option. The first line display the ZIP file name and the number of files that it contents. If /X option is used, the second line display the directory that will be used to restore selected files. If /X option is used, you can select files to restore : using the space bar select or unselect the file on the cursor ; F6 mark all files, then you can unselect unwanted files ; F5 unmark all files. Selected files are marked with an '*' just before the file name. When F3 is pressed, a list of all marked files is build and returned to PKZ which pass it to PKUNZIP. The file contening the list is created in the directory specified by the TMP environment variable or in the current directory. It is removed after execution. The file name is a ! following by a number. That program use all lines defined by the DOS mode. If mode is called to set the number of lines on the screen to 43 or 50, PKZL use 43 or 50 lines but does not change that. HOW PKZ WORKS ------------- First PKZ looks at all the options. For each R or X, S, V or L and E option, PKZ records the last directory specified on the command line by previous /D option. The same directory can be used for several operations. The order options are given is important : Example : PKZ /D d:êdir1 /R a:zip1 /D d:êdir2 /S a:zip2 - zip1 is restored to directory d:êdir1 - zip2 is used to save files in directory d:êdir2 Example : PKZ /DE d:êdir1 /S a:zip1 - save d:êdir1ê*.* in ZIP file a:zip1 - erase directory d:êdir1 But : PKZ /ED d:êdir1 /S a:zip1 - save d:êdir1ê*.* in ZIP file a:zip1 - no directory erased because there is no D before E. Operations are always executed in a specific order : 1 - Restore ZIP files specified by /R options in the order they appear in the command line 2 - Restore list of files specified by /FR option (if any) 3 - Change current drive and directory to drive and directory of the last /D option 4 - call the program (if any) 5 - Restore current drive and directory to original value 6 - Save directories to ZIP files specified by /S options in order they appear in the command line 7 - Save list of files specified by /FS option (if any) 8 - Delete list of files specified by /FD option (if any) 9 - Erase directories specified by options /E If a bad return code is received at any step, PKZ stops immediatly and other operations are not performed. That return code is returned to the caller. For a parameter error the return code is -1. Example : PKZ /D D:êTEST /RSE A:ZIPTST C:PROG P1 - restore ZIP file A:ZIPTST.ZIP to directory D:êTEST - change current default drive and path to D:êTEST - execute program C:PROG P1 - restore current drive and path to their original value - save D:êTESTê*.* to A:ZIPTST.ZIP - erase directory D:êTEST (all files including sub-directories) When a diskette drive unit is used, you must insert the diskette with the first ZIP file to restore, if any, before requesting the execution of PKZ. If 2 or more ZIP files are to be restored, a message is displayed : "Insure ZIP file is present" ; eventually change the diskette and you have to press "Enter". After program execution, the diskette with the first ZIP file for save or view operation must be present. If 2 or more ZIP files are to be used for save or view operation, a message is displayed : "Insure ZIP file is present", eventually change the diskette and you have to press "Enter". PKZ requires about 24K of memory. MULTI-VOLUMES PROCESSING ------------------------ That processing is requested by using Z: for the drive unit of a ZIP file. For the first PKZ operation, the FIRST diskette of the ZIP file concerned is assumed to be in the drive unit. PKZ sends messages to the standard error device (the display) to request all subsequents changes of diskette. If redirection is specified on the commmand line ( > xxx ) the messages are still displayed. When a message beginning with "Insert ..." is displayed, you have to put the requested diskette into the drive unit and then press "Enter". Operations for a save without update : Before that operation the ZIP file does not exist, PKZ expects that a diskette is in the drive unit at the beginning. A message "No control file found" is displayed ; that is only an information to indicate that the control file does not exist. The save is done as usual. But, when the diskette is full, a message is displayed : "Insert Next diskette to write ZIP", insert another diskette and, then, press "Enter" or "E" to erase all existing files or "F" to format the diskette (Format does not work on an OS/2-DOS session). The new diskette can already contain some files, but free space is needed at least for the first write. Of course, it is better to have an empty diskette to avoid diskettes manipulations. The process continues repeatedly until the end of the save. At that point, PKZ request the first diskette of that ZIP file : "Insert First diskette". Information on ZIP file are written to a control file on that diskette. After all save operations a test is done. Operations for a restore, a view or a test after a save : At the beginning, the first diskette of the ZIP file MUST be in the drive unit. PKZ reads the control file, if it is not found PKUNZIP works as if PKZ does not exist. If the message "No control file found" is displayed, the multi-volumes processing will not be done. That can appen when : - the actual ZIP file is really on one diskette, and it will be processed correctly ; - the present diskette is not the first of a multi-volume ZIP file and PKZIP will fail after a long time. In that situation, you can abort the process (Ctrl-Break). Otherwise, PKZ request the last diskette : "Insert ZIP diskette number n" where n is the number requested (the first diskette is number 1, and so on). Insert the diskette and press "Enter". PKUNZIP reads first information at the end of ZIP file to know the content. Generally, after that, PKZ request the diskette number 1,but there are some exceptions. If there are few bytes on the last diskette, PKZ can request the diskette number n-1 and then, again the diskette number n (n = last). For a view operation, nothing else is done. For a /FR option, it is not always the diskette number 1 that is requested first, it depends of the files to restore. For a restore or a save, diskettes are requested as needed, by number ; be sure to insert the good, otherwise a message is displayed : "Wrong diskette - Insert the good one". Operations for a save with update : At the beginning, the first diskette of the ZIP file MUST be in the drive unit. Because PKZIP first reads the ZIP file and update it in a temporary file created on drive C (or drive specified by /Bd), operations are exactly the same as for a restore. When update is done, PKZIP writes the temporary back file to the diskette. At that point, PKZ sends the message : "To keep old ZIP file, insert 1ST diskette of the new set, then press Y - Otherwise press N - ZIP file : " If you type "Y", you have to put the first diskette of a new set of diskettes. That enable you to keep the old ZIP file and to write the updated ZIP file on other diskettes. So you have the current save and the mother. Note that it is not the same as doing directly a save on new diskettes, because update keep all files in the ZIP file even if they are deleted on the disk. But update takes more time and needs disk space for temporary file. After, operations are the same as for a save. Re-used a set of diskettes : To be able to re-used a set of diskettes for the same ZIP file, you have only to delete 2 files on the first diskette : the ZIP file and the control file (same name with extension Z00). After you MUST insert diskettes in the same order to avoid problem when reading the ZIP file. You can use multi-volumes processing (drive letter Z) even if only one diskette is needed. The control file is created only when more diskette is needed. Each diskette contains 2 files : the ZIP file and a control file. Control files have the same name as the ZIP file with an extension Zhh, where hh is the hexadecimal number of the diskette (first diskette is Z00). Only the control file on the first diskette (.Z00) contains data ; all other control files have no data, they are only used to control the sequence of diskettes. The first control file contains an array of long integers with the exact number of bytes on each diskette. A maximum of 100 diskettes can be used for one ZIP file. PKZIP dates the ZIP file depending on the ZIPDATE parameter of PKZIP.CFG file. The normal PKZIP date is only on the last diskette, for all other diskettes the ZIP file date is the current date (it is a way to get the correct sequence if you have a problem). Following example : PKZ /D C:ê /ZG /S Z:SAVEC saves the entire drive C to diskettes that are put in drive G. To be able to do that, PKZIP.CFG configuration file must contain parameters to recurse sub-directories and save hidden and system files (see PKZIP.CFè).